From 125e80a64b1c366c35c0e78a719c18980eeabaf0 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 2 Jan 2009 20:55:54 +0000 Subject: [PATCH] Add docs svn path=/trunk/; revision=22042 --- ChangeLog | 6 ++++++ gtk/gtkentry.c | 5 +++++ gtk/gtkwidget.c | 4 ++++ 3 files changed, 15 insertions(+) diff --git a/ChangeLog b/ChangeLog index e22ba639fb..5c3124966d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2009-01-02 Matthias Clasen + + * gtk/gtkwidget.c: + * gtk/gtkentry.c: Add docs about using ::drag-begin for setting + a custom drag icon. + 2009-01-01 Matthias Clasen * configure.in: Bump version diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c index b7aa3b3778..20a21c8a3f 100644 --- a/gtk/gtkentry.c +++ b/gtk/gtkentry.c @@ -7613,6 +7613,11 @@ gtk_entry_get_icon_at_pos (GtkEntry *entry, * signal, and use gtk_entry_get_current_icon_drag_source() in * your signal handler to find out if the drag was started from * an icon. + * + * By default, GTK+ uses the icon as the drag icon. You can use the + * #GtkWidget::drag-begin signal to set a different icon. Note that you + * have to use g_signal_connect_after() to ensure that your signal handler + * gets executed after the default handler. */ void gtk_entry_set_icon_drag_source (GtkEntry *entry, diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index c451af390e..dddc2a63c0 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -1595,6 +1595,10 @@ gtk_widget_class_init (GtkWidgetClass *klass) * The ::drag-begin signal is emitted on the drag source when a drag is * started. A typical reason to connect to this signal is to set up a * custom drag icon with gtk_drag_source_set_icon(). + * + * Note that some widgets set up a drag icon in the default handler of + * this signal, so you may have to use g_signal_connect_after() to + * override what the default handler did. */ widget_signals[DRAG_BEGIN] = g_signal_new (I_("drag-begin"), -- 2.30.2